home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / itrack.lha / IntuiTrack.doc < prev    next >
Encoding:
Text File  |  1994-05-17  |  3.2 KB  |  88 lines
  1.  
  2.  
  3.                         IntuiTrack V1.0
  4.                         ===============
  5.  
  6.                     ©1994 by Matthias Meixner
  7.  
  8. License
  9. =======
  10.  IntuiTrack V1.0 ©1994 by Matthias Meixner. All rights reserved.
  11.  
  12.  This program  may be  freely distributed as long as all files are included
  13.  in the distribution without any modifications.   You may *NOT* charge more
  14.  than Fred Fish does for a single library disk.
  15.  
  16.  This program may *not* be uploaded on BBS's that  claim copyrights  on the
  17.  uploaded material.
  18.  
  19.  Commercial distribution of IntuiTrack and/or it's relative files is *NOT*
  20.  allowed without written permission from the author.   This  also means the
  21.  distribution on cover disks, disk magazines etc.
  22.  
  23.  
  24. Disclaimer
  25. ==========
  26.  The author cannot be held liable for the suitability or  accuracy  of this
  27.  manual  and/or  the  program(s)  it  describes.  Any  damage  directly  or
  28.  indirectly caused by the use or misuse of this manual  and/or the  program
  29.  it describes is the sole responsibility of the user her/him self.
  30.  
  31.  
  32. Description
  33. ===========
  34.  IntuiTrack implements resource tracking for intuition. It watches all tasks
  35.  that are started AFTER IntuiTrack has been started and keeps track of
  36.  windows, screens and screenlocks. If the task terminates and there are still
  37.  open windows, screens or screenlocks, then these resources are freed and
  38.  a warning is printed.
  39.  
  40.  NOTE: IntuiTrack watches tasks, not programs. This is an important
  41.  difference especially when you start programs using a shell, since the
  42.  programs are executed using the task of the shell when you do not "run" the
  43.  program. Therefore the shell should be started after IntuiTrack has
  44.  installed its patches to the system. The resources are freed when the task
  45.  is terminated, that is why it may be required to close the shell to free the
  46.  resources.
  47.  
  48.  IntuiTrack installes several patches to the system. It patches the calls
  49.  to AddTask and RemTask to keep track of the running tasks in the system.
  50.  IntuiTrack only watches tasks that have been started after IntuiTrack.
  51.  It can watch up to 100 Tasks at the same time. If there are more tasks than
  52.  that, it simply will not include them to the tasks under control.
  53.  Furthermore it patches some calls to functions of Intuition.
  54.  
  55.  IntuiTrack prints information about every task that has been captured or
  56.  released for resource-tracking, it gives you the name and the address of
  57.  the task. It also gives information about unfreed resources and prints the
  58.  name of the task that caused this.
  59.  
  60.  You may remove IntuiTrack via ^C. It will check, if it can safely remove the
  61.  patches and will wait if another program has patched the functions itself.
  62.  If this is the case then you will have to remove these patches first and
  63.  then retry removing IntuiTrack via ^C.
  64.  
  65.  
  66. Bugs
  67. ====
  68.  IntuiTrack will not keep track of resources, when it cannot allocate memory
  69.  for internal purposes, but in most cases you would not get the resource
  70.  itself if the system is low on memory. Since this does not have any other
  71.  negative effect I do not think that this is a real bug.
  72.  
  73.  
  74. Author
  75. ======
  76.  If you find bugs and/or have suggestions for IntuiTrack you can reach me:
  77.  
  78.    EMail: meixner@rbg.informatik.th-darmstadt.de
  79.  
  80.    or    Matthias Meixner
  81.          Sandberg 13
  82.          36145 Schwarzbach
  83.          Germany
  84.  
  85.  
  86.  
  87.  
  88.